Delen via

Manage orders - Gets a list of product promotions.

  • Referentie
Service:
Partner Center Rest
API-versie:
v1

Hiermee haalt u de beschikbare promoties van de partner op.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
Met optionele parameters: 
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}

URI-parameters

Name In Vereist Type Description
version
 path True

string

country
 query

string

Het land.
segment
 query

string

Het segment.

Aanvraagkoptekst

Name Vereist Type Description
Authorization True

string

Bearer-token voor autorisatie
ms-correlationid

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid is opgegeven, genereert de server een nieuwe voor elke aanvraag
MS-CV

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen MS-CV is opgegeven, genereert de server een nieuwe voor elke aanvraag
ms-requestid

string

Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag

Antwoorden

Name Type Description
200 OK

ResourceCollection[Contracts.V1.Models.ProductPromotion]

De aanvraag is geslaagd. De antwoordtekst bevat een lijst met promoties voor de partner.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definities

Name Description
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm
Link
ResourceAttributes
ResourceCollection[Contracts.V1.Models.ProductPromotion]
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Contracts.V1.Models.ProductPromotion

Object
Name Type Description
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

Object
Name Type Description
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

Object
Name Type Description
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Object
Name Type Description
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Object
Name Type Description
billingCycle

string

duration

string

Object
Name Type Description
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Object
Name Type Description
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.ProductPromotion]

Object
Name Type Description
attributes

ResourceAttributes

items

Contracts.V1.Models.ProductPromotion[]

links

ResourceLinks

totalCount

integer

Object
Name Type Description
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Object
Name Type Description
key

string

value

string